HandStack이란 무엇일까요?

HandStack의 역할과 한계를 구분하고, 게시판 학습을 시작할 경로를 고릅니다.

QCN

왜 HandStack을 써야 할까요?

  • 초급 개발자를 위한 풀스택 프레임워크 입문
  • 중소 기업을 위한 비즈니스 앱 개발 플랫폼
  • AI 협업 친화적인 개발 환경
QCN

HandStack 소개 (1/3)

  • HandStack은 풀 스택(Full-Stack) 개발 프레임워크입니다.

  • 표준 기술로 프론트엔드(사용자 화면)와 백엔드(서버 로직)를 모두 만들 수 있습니다.

QCN

HandStack 소개 (2/3)

  • 주요 기술
    • 백엔드: ASP.NET Core, Node.js
    • 데이터베이스: SQL Server, Oracle, PostgreSQL, MySQL/MariaDB, SQLite 기반 제품 및 서비스
    • 라이선스: 오픈소스 (MIT License)
QCN

HandStack 소개 (3/3)

  • 누구나 자유롭게 사용하고 기여할 수 있습니다.
QCN

왜 개발은 복잡하게 느껴질까요?

  • 배워야 할 것이 너무 많아요 (프론트엔드, 백엔드, 데이터베이스...)
  • 개발 환경 설정부터 막막해요.
  • 프로젝트 구조를 어떻게 잡아야 할지 어려워요.
  • 반복적인 코드를 계속 작성해야 해요.
  • 유지보수와 인수인계가 쉬웠으면 좋겠어요.

HandStack은 개발자와 운영자의 실무적인 어려움을 해결하기 위해 만들어졌습니다.

QCN

장점: 빠른 시작 (1/4)

  • CLI와 스크립트로 설치·모듈 관리·빌드·배포를 자동화합니다.
  • 아래는 Windows 배포본을 받아 설치하는 예입니다. 기존 작업 폴더와 분리해 실행합니다.
# Windows 에서 초기 설정 실행
cd C:/projects
curl -L -o handstack-win-x64.zip https://github.com/handstack77/handstack/releases/latest/download/win-x64.zip
powershell Expand-Archive -Path handstack-win-x64.zip -DestinationPath .
cd handstack
install.bat

https://handstack.kr/docs/startup/빠른-시작

QCN

계약 기반의 반복 작업 감소 (2/4)

  • 공통 거래 처리와 데이터 바인딩을 재사용해 반복 코드를 줄입니다.

  • 대표적인 예: 단일 엔드포인트 API

    • 복잡한 API 코드를 직접 작성할 필요 없이, SQL 쿼리와 백엔드의 실행 코드를 연계하는 데이터 조회/수정 API가 만들어집니다.
    • 백엔드에서 실행 되는 데이터베이스와 API 결과를 화면에 매우 쉽게 연결할 수 있습니다.
QCN

장점: 초급자 친화적인 구조 (3/4)

  • 프론트엔드와 백엔드가 하나의 프로젝트 안에서 유기적으로 연결됩니다.
    • 기술들이 분리되어 있을 때보다 전체 흐름을 이해하기 쉽습니다.
  • 모듈러 모놀리식 아키텍처를 기반으로 합니다.
    • 프로젝트가 커져도 길을 잃지 않도록, 기능별로 코드를 깔끔하게 정리할 수 있는 구조를 제공합니다.

마치 잘 정리된 서랍장처럼 필요한 코드를 쉽게 찾고 관리할 수 있습니다.
checkup 모듈의 항목 ID HAC010, HDM010 를 필터로 검색 해보세요.

QCN

장점: 실전 활용성 (4/4)

  • HandStack은 학습용으로도 좋은 도구이며, 다양한 업무 시나리오에 대응하기 위한 기업(Enterprise) 환경에서 필요한 기능들을 갖추고 있습니다.

    • 사용자 인증 및 권한 관리
    • 안정적인 데이터 처리 (트랜잭션)
    • 상세한 로그 기록
    • 외부 서비스 연동 (Open API)

  • HandStack으로 배운 기술은 개인/중소/대기업에 상관없이 실무에 바로 적용할 수 있습니다.

QCN

잠깐, 구분해 보기

단일 엔드포인트를 쓰면 SQL과 권한 설계도 없어질까요?

QCN

고려해야 할 단점

  • HandStack 고유의 학습 곡선

    • CLI 문법, 모듈 구조 등 HandStack만의 방식에 익숙해지는 시간이 필요합니다.
    • 자동화된 기능의 내부 동작 원리를 이해하기 전까지는 디버깅이 어려울 수 있습니다.

  • 자유도와 제약

    • 일정 규모 이상의 시스템이 필요한 정해진 구조와 방식을 따를 때 가장 큰 생산성을 발휘하지만, 숙련된 개발자에게는 다소 제약으로 느껴질 수 있습니다.
QCN

HandStack, 한마디로?

  • 표준 웹 기술과 오픈소스 모듈을 연결하는 프레임워크입니다.
  • 화면·SQL·함수는 직접 작성하고, 공통 연결 구조는 재사용합니다.
QCN

1일차 학습 과정 (1/2)

  • HandStack이란 무엇일까요

  • 내 컴퓨터에 개발 환경 꾸미기

  • HandStack으로 첫 프로젝트 실행하기

  • HandStack 프로젝트의 큰 그림 그리기

  • 업무 모듈 디렉토리 깊게 파헤치기

  • HandStack 라우팅의 마법

  • 클라이언트 디렉토리와 화면 구조 이해하기

QCN

1일차 학습 과정 (2/2)

  • 나만의 첫 화면 만들기 (클라이언트 사이드)

  • 화면의 동작과 업무 구현을 위한 공통 라이브러리

  • 화면의 공통 UI UX 제공을 위한 공통 컨트롤

  • repository 모듈을 이용한 파일 업로드, 다운로드

QCN

2일차 학습 과정 (1/2)

  • 기초코드와 코드도움을 이용한 화면 데이터 관리

  • 클라이언트와 서버 데이터 연동 테스트

  • 데이터 거래란 무엇인가요

  • HandStack이 만들어준 API 사용하기

  • 데이터베이스 쿼리 계약 관리하기

  • SQL 처리를 위한 다양한 확장 기능

  • 거래 로그 데이터베이스 설정하기

QCN

2일차 학습 과정 (2/2)

  • HTTP 클라이언트로 거래 데이터 및 SQL 테스트 하기

  • Tabler, Master CSS, Mustache 로 만드는 화면 레이아웃

  • 화면 UI 레이아웃 템플릿 사용하기

  • UI 화면과 거래 로그로 디버깅하기

  • tasks 작업 스크립트로 반복 작업 관리하기

QCN

우리가 함께 만들 첫 프로젝트 (1/3)

  • 간단한 "나만의 게시판" 만들기
QCN

우리가 함께 만들 첫 프로젝트 (2/3)

  • HandStack을 이용해 다음 기능들을 구현해 볼 거예요.
    • 데이터베이스 스키마 관리
    • AI 를 이용한 CRUD 쿼리 작성
    • 게시판 글 목록 보기
    • 새로운 글 작성하기
    • 글 내용 보기
QCN

우리가 함께 만들 첫 프로젝트 (3/3)

  • 이 과정을 통해 HandStack의 강력하고 편리한 기능들을 자연스럽게 익히게 될 것입니다.
QCN

오픈소스 생태계는 함께할 때 더 가치가 있습니다

  • 소스와 문서는 GitHub에서 관리합니다.
  • 이슈·개선 제안·활용 사례·병합 요청으로 참여할 수 있습니다.
  • 운영 중 발견한 문제는 재현 절차와 함께 공유합니다.
QCN

이제 시작 해볼까요?

  • HandStack에 대해 더 궁금하다면 공식 문서를 둘러보세요.
  • 앞으로 진행될 학습을 통해 여러분도 풀스택 개발자가 될 수 있습니다.
  • 공식 GitHub
    • https://github.com/handstack77/handstack
  • 공식 문서 GitHub
    • https://github.com/handstack77/handstack-docs
  • https://handstack.kr
QCN

시작할 준비

  • 화면·거래·실행 모듈의 역할을 설명할 수 있습니다.
  • 장점과 학습 비용을 비교해 적용할 업무를 고릅니다.
  • 게시판 예제로 목록·등록·상세 조회를 이어서 익힙니다.
QCN

발표: 첫 화면의 목표를 말한 뒤 핵심 개념과 예제로 진행합니다. 확인 질문 뒤에는 답할 시간을 주고, 마지막 완료 기준을 남겨 질문을 받습니다. 발표 구성 참고: MIT OpenCourseWare, Patrick Winston, How to Speak (2018), https://ocw.mit.edu/courses/res-tll-005-how-to-speak-january-iap-2018/pages/how-to-speak/

질문 후 잠시 기다립니다. 답이 없으면 앞에서 본 예제를 다시 가리킵니다. 확인할 답: 연결 코드를 줄여도 업무 SQL, 인증·인가, 테스트는 설계해야 합니다. 다음 주제로 넘어가기 전에 차이를 청중의 표현으로 한 번 확인합니다.

질문을 받는 동안 이 확인 기준을 화면에 남깁니다. 청중이 자신의 업무에 적용할 다음 행동 하나를 고르게 합니다.